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(54) System and method for propagating revisions through a communications network 



(57) A system, and method of operation, for propo- 
gating revisions through a comrhunications network. 
The system includes: (1) status reporting circuitry, asso- 
ciated with ^ second node ^^^^ 
work, for collecting and transmitting a current'staTus of 
second node informjatjon stored in a memorVof the jgc- 
orid node, (2) first information revising circuitry, associ- 
ated with a first node of the communications network, 
for receiving the current status from the second node, 
determining as a function of the current status whether 
a revision of the second node Inforrnatlon is required 
and, If the revision is required, transmitting the revision 
to the second node to revise the second node irtforma- 
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tion and (3) second information revising circuitry, asso- 
ciated with the second node of the communications 
network, for receiving a current status from a third node 
of the communications network, determining as a func- 
tion of the current status from the third node whether a 
revision of third node Information stored in a memory of 
the third node is required and. If the revision is required, 
transmitting the revision received from the first node to 
the third node to revise the third node information, the 
revision thereby propagating through the communica- 
tions network via the first, second and third nodes 
thereof. 
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Description 
COPYRIGHT NOTICE 

5 A portion of the disclosure of this patent document contains material which is subject to copyright protection. The 

copyright owner has no objection to the facsimile reproduction by anyone of the patent document or the patent disclo- 
sure, as it appears in the Patent and Trademark Office patent file or records, but othenwise reserves all copyright rights 
whatsoever. 

10 TECHNICAL FIELD OF THE INVENTION 

The present invention is directed. In general, to communications networks and, more specifically, to a system and 
method for distributing updates to nodes of a hierarchical communications network that cascade the updates through 
the network as a function of its hierarchy. 

15 

BACKGROUND OF THE INVENTION 

Immeasurable gains in technology offered in personal computers ("PCs') have allowed PCs to assume roles per- 
formed only by mainframe or minicomputers in the past. Many companies and, for that matter, individual users rely 

20 largely on commercially-available PCs to meet their information processing needs. Thus, it is vital that their PCs perform 
reliably. The fault tolerance of a given computer system is a sensitive issue with companies and individual users given 
the level of reliance they place on their computing systems. 

Initially PCs were stand-alone devices, each containing separate hardware, operating system, application software 
and user data. As use of PCs spread within business organizations, however, the need for shared data and hardware 

25 resources grew, and local area network ("LANs") came into being. A LAN (or its more-geographically-dispersed coun- 
terpart, the wide area network ("WAN")) includes a number of PCs ("clients") linked to one another (typically by a high 
speed serial communications link) and centers around a relatively high performance PC or minicomputer ("server") that 
delivers programs and data to the clients and manages system-wide resources, such as secondary storage units and 
printers. 

30 The networking concept has proven very useful, but suffers from a couple of disadvantages. First, since manage- 
ment of the network is focussed in the server, the overall performance of the network is compromised whenever the 
sender becomes a processing bottleneck Second, since programs and data are delivered by the server to its various 
clients, a distribution problem occurs whenever a software provider or vendor modifies one of Its programs or data. The 
modified program or data must typically be distributed from the server to the client computers in a timely manner, often 

35 within a single business day. In a prior art solution, the server, or a "host" computer identified by the server, is respon- 
sible for sequentially traversing each of the client computers supporting an "old" version of the modified program or 
data, and then updating those client computers as necessary to implement the "new" version. In an alternate prior art 
solution, the server, or the host computer, traverses each client computer, updating each to include certain ones of the 
server's files. 

40 A problem inherent to the prior art solutions is that substantial server, or host, processing resources may be spent 
establishing a communication link with many, if not ail, of the client computers, and then updating the same. Further, if 
the server Is responsible for performing the updates and the number of client computers being serviced by the server 
Increases, the overall performance of the network may significantly be compromised as the server becomes a process- 
ing bottleneck. A system and method are needed for propagating revisions to programs or data through a communica- 

45 tions network wherein the communications network, and in particular the server's resources, are neither compromised 
nor wasted. The inability of conventional solutions to accomplish the foregoing remains a dominant obstacle to updating 
software products distributed among various ones of the client computers of a communications network 

SUMIVIARY OF THE INVENTION 

50 

To address the above-discussed deficiencies of the prior art, the present invention provides a system, and method 
of operation, for propagating revisions through a communications network, wherein the communications network 
includes a plurality of associated nodes. 

The system includes: (1) status reporting circuitry, associated with a second node of the communications network, 
55 for collecting and transmitting a current status of second node information stored In a memory of the second node, (2) 
first information revising circuitry, associated with a first node of the communications network, for receiving the current 
status from the second node, determining as a function of the current status whether a revision of the second node 
information is required and, if the revision is required, transmitting the revision to the second node to revise the second 
node Information and (3) second information revising circuitry, associated with the second node of the communications 
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network, for receiving a current status from a third node of the communications network, determining as a function of 
the current status from the third node whether a revision of third node information stored in a memory of the third node 
is required and, if the revision is required, transmitting the revision received from the first node to the third node to revise 
the third node information, the revision thereby propagating through the communications network via the first, second 

5 and third nodes thereof. 

The present invention therefore allows revisions to propagate automatically through a communications network. 
Nodes in the network are responsible for both detecting when a revision to information in another node is necessary 
and transmitting the revision to the other node. "Information," as used the term is used herein, is defined broadly to 
encompass both instructions (e.g., programs, functions, tasks, subroutines, procedures and the like) and data. The 

10 "information" subject to revision by the present invention may, for example, be a computer program (allowing automatic 
distribution of program updates, fixes, tools and the like), computer data {e.g., documents, spreadsheets, databases, 
data files and the like), video data or the like. 

In one embodiment of the present invention, at least the second information revising circuitry includes memory for 
storing a subscriber list, wherein the second information revising circuitry transmits the above-described revision as a 

15 function of the content of the subscriber list. The present invention is therefore able to form the core of a fee-based 
update service, wherein subscribers pay for revisions. The amount of information revised and the frequency of the revi- 
sions may be selectable, allowing a range of fee-based services to be offered. In a related embodiment, the subscriber 
list and the current status are suitably processed to identify a subset of the information of the subscriber list that is avail- 
able to a particular user or group of users, the processing therefore functioning as a filter for the subscriber list. 
( In one embodiment of the present invention, the status reporting circuitry collects and transmits the current status 

of the second node information to the first node at a first time, status information circuitry associated with the third node 
collecting and transmitting the current status from the third node to the second node at a second time, the second time 
subsequent to the first time by a period of time sufficient to allow the second node information to be fully revised before 
the second information revising circuitry transmits the revision to the third node. This allows orderly "waves" of revisions 

25 to propagate through the network. Alternatively, revisions may be distributed in a more random fashion, as one node 
determines that another requires a revision. 

In one embodiment of the present invention, the second information revising circuitry is embodied in a sequence of 
instructions operable on a second processor associated with the second node, the revision capable of including revi- 
sions to the sequence of instructions, thereby allowing an operation of the second information revising circuitry to be 

30 modified or altered. The information revising circuitry itself may therefore be allowed to change or be updated. ;^ 
The communications network is hierarchical, in one embodiment of the present invention, the first node functions 
as a server for the second node, the second node functions as a server for the third node. "Hierarchical", as the term is 
used herein, means a structure of many levels wherein particular levels have control or precedence over other levels 
{e.g., higher precedence levels over lower precedence levels), and wherein a first level node may be hierarchically 

35 related to one or more second level nodes, each second level node may be hierarchically related to one or more third 
level nodes, each third level node may be hierarchically related to one or more fourth level nodes, etc. Precedence may 
suitably be based upon order (e.^. sequentially), responsibility, functionality, etc. The broad scope of the present inven- 
tion therefore encompasses tree-based networks, as well as flat, peer-to-peer networks. The present Invention is fur- 
thermore not limited to computer networks, such as LANs or WANs, but rather Is operable In telecommunication 
systems to update system software or data or In wireless environments, such as cellular telephony or message paging 
networks. 

In one embodiment of the present invention, the first information revising circuitry includes first security circuitry for 
authenticating the current status received from the second node before the first node transmits the revision to the sec- 
ond node and the second node includes second security circuitry for authenticating the revision received from the first 
45 node before revising the second node information. In a related embodiment, the second security circuitry authenticates 
the revision on a file-by-file basis. Of course, the security circuitry may be in the form of computer instructions, allowing 
the circuitry to change or be updated over time. 

In one embodiment of the present invention, the first information revising circuitry revises the second node informa- 
tion by logging onto the second node and transmitting a sequence of commands to the second node to enable the see- 
so ond node to receive the revision. The present invention therefore operates in a conventional network environment and 
may therefore be completely transparent to the underlying network operating system ("NOS"). Security and other fea- 
tures of the NOS may therefore remain intact. 

An advantageous embodiment for using and/or distributing the present invention is as software. The software 
embodiment includes a plurality of instructions which are stored to a suitable conventional memory or other equivalent 
55 storage medium. The instructions are readable and executable by one or more network nodes having processing cir- 
cuitry. The instructions, upon execution, direct the processing circuitry to propagate revisions through a communica- 
tions network wherein the communications network includes a plurality of associated nodes in accordance with the 
present invention. Exemplary memory and storage media include without limitation magnetic, optical, and semiconduc- 
tor, as well as suitably arranged combinations thereof. 
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The foregoing has outlined, rather broadly, preferred and alternative features of the present invention so that those 
skilled in the art may better understand the detailed description of the invention that follows. Additional features of the 
invention will be described hereinafter that form the subject of the claims of the invention. Those skilled in the art should 
appreciate that they can readily use the disclosed conception and specific embodiment as a basis for designing or mod- 
5 ifying other structures for carrying out the same purposes of the present invention. Those skilled in the art should also 
realize that such equivalent constructions do not depart from the spirit and scope of the invention in its broadest form. 

BRIEF DESCRIPTION OF THE DRAWINGS 

10 For a more complete understanding of the present invention, reference is now made to the following descriptions 
taken in conjunction with the accompanying drawings, in which like numbers designate like parts, and in which: 

FIGURE 1 illustrates a block diagram of a conventional hierarchical communications network in which the principles 
of the present invention may advantageously be implemented; 
IS FIG U RE 2 illustrates an isometric view of an exemplary processing system node chat provides a suitable environ- 
ment within which the present invention may be implemented and operated in accordance with the communications 
network of FIGURE 1; 

FIGURE 3 illustrates a high-level block diagram of an exemplary microprocessing circuit that may suitably be asso- 
ciated with the processing system of FIGURE 1 and that provides a suitable environment within which the present 
20 invention may be implemented and operated; 

FIGURE 4 illustrates a high-level block diagram of a single exemplary branch of the communications network of 
FIGURE 1; and 

FIGURE 5 illustrates a flow diagram of an exemplary method of operation for propagating revisions through the 
communications network of FIGURE 1 in accordance with the principles of the present invention. 
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DETAILED DESCRIPTION 

r— 

I Referring initially to FIGURE 1. illustrated is a biqck diagram of a conventional hierarchical communications net- 
work, a computer network (generally designated 100). in which the principles of the present invention may advanta- 
geously be implemented. Exemplary network 100 includes a server node 110 and a plurality of conventional client 
nodes 1 20a-120c. 130a-130f and 140a-140h. "Include." as the term is used herein, is defined as inclusion without lim- 
itation. A "node." as the term is used herein, is defined as any junction, end or connection point, station, terminal or the 
like, whether portable or not. that is capable of communicating signals, or information, within communications network 

Server node 110 may suitably and conventionally be sharable by client nodes 120a-120c. 130a-130f and 140a- 
140h. Server node 110 and cfient nodes I20a-120c, 130a-130f and 140a-140h may suitably be associated with one 
another, either directly or indirectly, by any conventional means, including communication links, portal devices (eg 
routers, bridges, gateways, switches, etc.) or the like. "Associated with," as the term is used herein, means to include 
within, interconnect with, contain, be contained within, connect to. couple with, be communicable with, juxtapose coop- 
erate with, interleave or the like. "Or," as the term is used herein, is inclusive, meaning and/or. 

The illustrated association of nodes 110, 120a-120c, 130a-130f and I40a-140h suitably facilitates resource sharing 
as well as the balancing of resource requests among ones of the nodes, techniques that are known in the art. Commu- 
nication among vanous ones of the nodes may suitably include the transmission and reception of signals Each com- 
munication signal may suitably be divided into packets, frames, messages, sequences of data or any other variation of 
a physical quantity for conveying information. A typical signal may suitably include a collection of related data items 
such as discrete data, address or instruction objects that may be used to communicate information between various 
ones of the nodes. 

In an advantageous embodiment, as will be discussed in greater detail with reference to FIGURES 4 and 5 revi- 
sions to at least a portion of the information stored on server 1 10 may suitably be propagated on a level-by-level basis 
through communications network 100 in accordance with the principles of the present invention. "Revisions" as the 
term is used herein, means changes, modificatrons, additions, deletions, adjustments, alterations, variations customi- 
zations, and the like. More particularly, at least one of the second level nodes 120a-120c collects and transmits a sec- 
ond level cun-ent status of information stored in the one or more second level nodes. The second level current status of 
information may suitably be for the entire level or for individual ones of second level nodes 120a-120c Server 1 10 a 
first level node, receives the second level current status of information and determines, as a function of the second level 
cun-ent status of infomiation. whether a revision of one or more of the second level nodes* information is required If the 
revision is required, sender 110 transmits the revision of the second level node information to the one or more second 
level nodes 120a-120c. 

After the revision, the one or more second level nodes 120a-120c may suitably receive a third level current status 
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of information from at least one third level node 130a-130f, and determine, as a function of the third level current status 
of information, whether a revision of the one or more third level nodes' information is required. The third level current 
status of information may similarly be for the entire level or for individual ones of third level nodes 130a-1 30f. If the third 
level revision is required, the one or more second level nodes 120a-120G transmit at least part of the revision received 

5 from server 1 10 to the one or more third level nodes 130a-130f to thereby revise the third level node information. 

An important aspect of the above-identified and -described embodiment is the breadth-first-type, or "fan-out." 
update. More particularly, revisions to the first level node information are suitably propagated through ones of the sec- 
ond level nodes, then the third level nodes, and so on, such that the revisions to the first level node information may be 
propagated through communications network 100 in an exponential mann er. | 

10 Turning to FIGURE 2, illustrated is an isometric view of an exemplary processing system, a PC (generally desig- 
nated 200). Processing system 200 Is capable of functioning as any node 110, 120a-l20c, 130a-130f and 140a-140h 
within exemplary communications network 100. Processing system 200 suitably includes a chassis 205, a display 
device 210 and a keyboard 215. Chassis 205 includes a hard disk drive 220 and a floppy disk drive 225. Floppy disk 
drive 225 may suitably be replaced by or combined with other conventional structures for transferring data or instruc- 

15 tions, including tape and compact disc drives, telephony systems and devices (including telephone, video phone, fac- 
simile or the like), network communication ports and the like. 

Chassis 205 is partially cut-away to illustrate a battery 230, a clock 235, a detached local memory 240 and process- 
ing circuitry 245 ("CPU"), all of which are suitably housed therein. Detached local memory 240 is operative to store data 
and instructions. The stored instructions may suitably be grouped into sets of tasks, including programs, procedures. 
( subroutines, functions, and the like. Processing circuitry 245, which is associated with detached local memory 240, Is 
operative to execute selected ones of the instructions stored therein to propagate revisions to the stored data and 
instructions through communications network 100 in accordance with the principles of the present invention. 

In an advantageous embodiment, display device 210 is operative to provide a display area 250 that is accessible 
to executed ones of the plurality of instructions, and that is capable of displaying a graphical user interface. Further cou- 

25 pled through individual conventional connectors (not shown) on chassis 205 are a mouse 255 and a printer 260. Exem^ 
plary peripheral devices 210. 215. 255 and 260. all of which are associated with processing circuitry 245. allow 
processing system 200 to interact with a user. Exemplary peripheral devices 210, 215, 255 and 260 may suitably be 
replaced by or combined with other conventional user interfaces. 

Although processing system 200 is illustrated having a single processor, a single hard disk drive and a single local 

30 memory, processing system 200 may suitably be equipped with any multitude or combination of processors or storage « 
devices. Processing system 200 may, in point of fact, be replaced by, or combined with, any suitable node operative in 
accordance with the principles of the present invention, including sophisticated calculators, and hand-held, laptop/note- 
book, mini, mainframe and super computers, telephony systems {e.g,, sound, video, data, etc.), message paging sys- ^ 
tems, portal devices and the like, as well as network combinations of the same. 

35 Conventional processing system architecture is more fully discussed in Computer Organization and Architecture. ' 
by William Stallings, MacMillan Publishing Co. (3rd ed. 1993); conventional processing system network design is; more 
fully discussed in Data Network Desion . by Darren L Spohn, McGraw-Hill, Inc. (1993); and conventional data commu- - 
nications is more fully discussed in Data Communications Principles, by R. D. Gitlin. J. F Hayes and S. B. Weinstein, 
Plenum Press (1992) and in The Inwrn Handbook of Telecommunications, by James Harry Green, Irwin Professional 
Publishing (2nd ed. 1992), Each of the foregoing publications is incorporated herein by reference. 

Turning to FIGURE 3, illustrated is a high-level block diagram of an exemplary microprocessing circuit (generally 
designated 300) that may suitably be associated with a processing system, such as PC 200 of FIGURE 2. Micro- 
processing circuit 300 includes detached local memory 240, processing circuitry 245, bus controller circuitry 305, a 
conventional read-only memory ("ROM") 310 and a set of peripheral ports 315. A host bus 320 is shown and is suitably 

45 operative to associate processing circuitry 245, detached local memory 240 and bus controller circuitry 305. In accord- 
ance with the illustrated embodiment, detached local memory 240 may suitably include random access memory 
("RAM"), and processing circuitry 245 may suitably include one or more processors acting in concert. 

An input/output ("I/O") bus 325 is shown and is operative to associate bus controller circuitry 305, ROM 310 and 
the set of peripheral ports 315. The set of peripheral ports 315 may suitably couple I/O bus 325 to peripheral devices 

50 210, 215, 255, and 260 of FIGURE 2 for communication therewith. Included among the set of peripheral ports 31 5 may 
suitably be a serial or a parallel port. Bus controller circuitry 305 provides suitable means by which host bus 320 and 
I/O bus 325 may be associated, thereby providing a path and management for communication therebetween. In accord- 
ance with the illustrated embodiment, host bus 320 is relatively fast to facilitate rapid communication between process- 
ing circuitry 245 and detached local memory 240 and is typically burdened with as few conrponents as possible to 

55 maximize its speed. I/O bus 325 is allowed to run at a slower pace with respect to host bus 320 because its speed is 
less critical. Each of the lines of the buses 320, 325 require a drive current to carry signals thereon. Accordingly, the 
present invention operates in conjunction with a conventional system controller (not shown) that supplies the required 
drive current. Of course, the present invention may also suitably function within an architecture that only has a single 
bus. 
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In alternate preferred embodiments, microprocessing circuit 300, in whole or in part, may be replaced by, or com- 
bined with, any other suitable processing circuitry, including programmable logic devices, such as programmable array 
logic ("PALs") and programmable logic arrays ("PLAs"). digital signal processors ("DSPs"), field programmable gate 
arrays ("FPQAs"), application specific integrated circuits ("ASICs"), very large scale integrated circuits ("VLSIs") or the 

5 like, to form the various types of circuitry described and claimed herein. 

Turning momentarily to FIGURE 4. illustrated is a high-level block diagram of a single exemplary branch (generally 
designated 400), or a collapsed hierarchy, of communications network 100 of FIGURE 1 . Exemplary server 1 10 and cli- 
ent nodes 120a and 130a form a hierarchical communications path wherein the illustrated nodes are suitably associ- 
ated via conventional communication links 405 and 410. respectively. FIGURE 4 is presented for the purposes of 

10 illustration in connection with the discussion of FIGURE 5 only Although the illustrated embodiment focuses upon a 
tree-based hierarchical network, those of ordinary skill in the art will realize that the principles of the present invention 
are applicable in any suitably arranged communications networking environment {e.g., peer-to-peer networks, etc) 
The present invention provides a means by which revisions to information associated with one or more first level nodes 
may suitably be communicated to one or more second level nodes, from at least one of the one or more second level 

15 nodes to one or more third nodes, from at least one of the one or more third level nodes to one or more fourth nodes, 
etc. The present invention therefore facilitates the propagation of revisions through a communications network at an 
exponential rate. 

P Turning to FIGURE 5. illustrated is a flow diagram of an exemplary method of operation of communications network 
100 for propagating revisions through branch 400 of FIGURE 4, and more particularly, server 110 and client nodes 
20 I20a and 130a, in accordance with the present invention. The present discussion is undertaken with reference to FIG- ( 
URE 4. and it is assumed that each of exemplary nodes 110, 120a and 130a includes a suitable processing means 
such as microprocessing circuit 300 of FIGURE 3 or other suitable implementation capable of providing equivalent func- 
tionality. An exemplary source code embodiment is attached hereto as APPENDIX A and is incorporated herein by ref- 
erence for all purposes. The exemplary embodiment is written in conventional Korn Shell code for use with a UNIX 
25 environment. System V Release 4 ("SVR4"). 

For purposes of discussion, it is further assumed that server node 110 receives revisions to information stored in a 
memory associated therewith. The revisions may suitably be received from any of a number of sources including soft- 
ware providers/vendors. for example. 

The illustrative process begins when client node 1 20a scans its associated memory studying the information stored 
thereon (e,g,, files, database, data configurations, programs, routines, subroutines, functions, tasks, and the like) and 
generates a status report (process step 500). The status report represents the current status of client node 120a Infor- 
mation, and may suitably Include an Identifier to identify various client node information, a version number associated 
with various client node Information, a revision date associated with various client node information, or the like. The 
scanning process may suitably be Initiated externally by server node 1 10 or internally by client node 120a. In either sit- 
uation, the initiation may suitably be performed periodically or aperiodlcally. 

Client node 120a, possibly using one of peripheral ports 315, transmits the status report to sender node 110 
(input/output step 505). Server node 1 1 0. possibly using one of Its peripheral ports 31 5. receives the transmitted status 
report and suitably verifies the accuracy of the transmission (process step 51 0). Techniques for verifying the transmis- 
sion of data are known. 

40 In an advantageous embodiment, server node 1 101s further operative to authenticate the current status of client 
node 120a by logging onto client node 120a. and confirming the information within the received status report. "Authen- 
ticate." as the term Is used herein, means to establish the authenticity of, prove genuine or the like, including confirm ^7-^?^/-^/^ '^r>^ 
corroborate, prove, substantiate, validate, verify, or the like. For example, if the received status report indicates that cli- H 
ent node 1 20a includes version 1 .0 of software package XYZ. server 1 10 may suitably log onto client node 1 20a to con- r,'^] . 

45 firm that client node 120a in fact includes version 1 .0 of software package XYZ. Often times, stored information, such i> X^"^' 
as software package XYZ. includes a plurality of files. In a related embodiment therefore, server 110 authenticates the ^^/^^ I^V 
status report on a file-by-file basis. 

Server node 1 1 0, if the status report was con-ectly received, determines as a function of the received status report 
whether a revision of client node 120a stored Information Is required (decisional step 515). In another advantageous 

so embodiment, a suitable inventory is maintained, either directly or Indirectly, by server node 1 1 0. The Inventory includes 

a list of the information maintained, used, provided, or the like by server node 1 1 0, and possibly client node 1 20a The ^l7~\^ i-^ 
determination of whether client node 120a stored information requires revision is suitably performed by comparing the T// 7 > K . > 7> 
status report with the Inventory thereby identifying information that (1) Is missing from client node 1 20a (2) may suitably i i^^t- v:? 
be removed from client node 120a. (3) Is not a recent version, (4) is expired, such as under the terms of a license agree- ''^-^'L-^^^^ 

55 ment. or the like. Conventional techniques for performing comparisons are known. 

In connection with licensing an-angements. the above-referenced identification process may suitably be used to 
Identify valid, invalid, out-of-date or the like subscriber information maintained by client node 120a, an aspect of the 
present invention that is discussed In greater detail hereinbelow. 

If client node 120a stored information requires revision (YES branch of decisional blockSIS), server node llOsult- 
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ably creates an information revision file for transmission to client node 120a (process step 520). An exemplary informa- - 
tion revision file may suitably include programs, functions, tasks, subroutines, procedures, documents, spreadsheets, ' i^^^7/>v< 
databases, data files, data configurations, or the like. The revision file may also suitably include a set of instructions for 
execution by client node 120a, the executed set of instructions may suitably direct client node 120a to install the remain- 
der of the information revision file, perform transmission verifications, security or the like. 

Server node 1 10, possibly using one of peripheral ports 315, suitably transmits the revision file to client node 120a 
(input/output step 525). Client node 120a, again possibly using one of its peripheral ports 315, receives the transmitted p v 
revisions file and verifies the accuracy of the transmission (process step 530). If the transmission was correctly ^/-/v^^?.'-*'-^. a 
received, the stored Information on client node 120a is updated using the received revision file (process step 535). . 1 

The foregoing update may suitably be performed in any one of a number of ways, for example, server node 110 
may suitably update client node 120a stored information by logging onto client node 120a and one of: 



(a) perform the update in a conventional "master-slave"-type environment (/.e., communications session in which 
one side, called the master, initiates and controls the session, and the other side, called the slave, responds to the 

15 master's commands), and 

(b) transmit a sequence of commands to client node 120a that, upon execution by client node 120a. enable client 
node 120a to perform the update. 

In another example, client node 120a receives the revision file from server 110, buffers the received revision file, and 
( suitably performs the update. Client node 120a may also receive the above-identified set of instructions as part of the '^Vp^^f 

revision file, the set of instructions, when suitably executed by client node 120a, direct client node 120a to Install the '/"^i^yh^'^tlfl 
remainder of the buffered revision file, or alternatively, to perform transmission verifications, security or the like. 

In accordance with the illustrated embodiment, client node 120a. a second level client In network branch 400, may 
suitably function as a temporary "server" to client node 130a. a third level client In network branch 400. 

25 The illustrative process continues when client node 130a scans its associated memory studying the information 
stored thereon {e.g. , files, database, data configurations, programs, routines, subroutines, functions, tasks, and the like) 
and generates a status report (process step 540). The status report represents the current status of client node 130a 
information, and may suitably include an identifier to identify various client node Information, a version number associ- 
ated with various client node Information, a revision date associated with various client node information, or the like. The 

30 scanning process may suitably be initiated externally by client node 120a or internally by client node 130a. In either sit- - 
uation, the initiation may again suitably be performed periodically or aperiodically. 

Client node 130a, possibly using one of peripheral ports 315, transmits the status report to client node 120a ^7^^/./^^^^ 
(input/output step 545). Client node 120a, possibly using one of its peripheral ports 315, receives the transmitted status ^ ' ' ^ 

H report and suitably verifies the accuracy of the transmission (process step 550). 
In an advantageous embodiment, client node 120a is further operative to authenticate the current status of client ^ 
node 130a by logging onto client node 130a, and confirming the information within the received status report. In a ^^^^X "^t^ 
related embodiment, the authentication of the status report, portions of which may again include a plurality of files, is 
performed on a file-by-file basis. 

, Client node 120a, If the status report was correctly received, determines as a function of the received status report ^ 

whether a revision of client node 130a stored Information is required (decisional step 555). In yet another advantageous ' ^'h/t 
embodiment, a suitable inventory is maintained, either directly or indirectly, by client node 120a. The inventory includes ^ f^li^n 

a list of the information maintained, used, provided, or the like by client node 120a. and possibly client node 130a or 
server node 110. The determination of whether client node 130a stored information requires revision Is suitably per- 
formed by comparing the status report with the inventory thereby Identifying information that (1) is missing from client 

45 node 1 30a. (2) may suitably be removed from client node 1 30a, (3) is not a recent version, (4) is expired, such as under 
the terms of a license agreement, or the like. 

In connection with licensing arrangements, tiie above-referenced Identification process may suitably be used to 
identify valid, invalid, out-of-date or the like subscriber Information maintained by client node 130a, an aspect of the 
present invention that is discussed in greater detail hereinbelow. 

so If client node 1 30a stored Information requires revision (YES branch of decisional block 555). client node 120a suit- "f^^'i "^"^F^-^l^ 
ably creates an information revision file for transmission to client node 130a (process step 560). The Information revi- iCIlCh ^ *^ i f"^ 
slon file may suitably include, at least in part, the revision file received by client node 120a from server node 110. ^ ' 

An exemplary Information revision file may suitably include programs, functions, tasks, subroutines, procedures, 
documents, spreadsheets, databases, data files, data configurations, or the like. The revision file may also suitably '^r^^'-i'^ n'o4?y\ 

55 Include a set of Instructions for execution by client node 1 30a. the executed set of instructions may suitably direct client ^nff^)^^^"^" 
node 130a to install the remainder of the Information revision fine, perform transmission verifications, security or the 
like. 

Client node 120a, possibly using one of peripheral ports 31 5, suitably transmits the revision file to client node 1 30a ^, >/ ^ 
(input/output step 565). Client node 1 30a, again possibly using one of its peripheral ports 315, receives the transmitted 
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revisions file and verifies the accuracy of the transmission (process step 570). If the transmission was correctly 
received, the stored information on client node 130a is updated using the received revision file (process step 575). 

The foregoing update may suitably be performed in any one of a number of ways, for example, client node 120a 
may suitably update client node 130a stored information by logging onto client node 130a and one of- ^ ? ^'^ 

(a) perform the update in a conventional "master-slave"-type environment (/.e., communications session in which 
one side, called the master, initiates and controls the session, and the other side, called the slave, responds to the 
master's commands), and 

(b) transmit a sequence of commands to client node 130a that upon execution by client node 130a, enable client 
node 130a to perform the update. 

In another example, client node 130a receives the revision file from client node 120a, buffers the received revision file, 
and suitably performs the update. Client node 130a may also receive the above-identified set of Instructions as part of 
the revision file, the set of instructions, when suitably executed by client node 130a. direct client node 130a to install the 
remainder of the buffered revision fine, or alternatively, to perform transmission verifications, security or the like. 

The above-identified and -described process may suitably be performed in a conventional network environment 
and may further suitably be transparent to the underlying network operating system ("NOS"). This feature enable con- 
ventional security and other features of the NOS to remain intact. 

An important aspect of various embodiments of the present invention, is that either client node 120a or 130a may 
suitably include a sequence of instructions for performing at least a portion of the above-described update process 
which itself is subject to an update by the received information revision file. The sequence of instructions may suitably 
be revised by the received revision file, and then suitably executed, thereby allowing one or more operations of one of 
client node 120a or 130a to be modified and allowed to change or be updated over time. 

Another important aspect of the present invention as exemplified by the illustrated embodiment, is that client node 
1 30a stored information may suitably be revised, at least in part, by the revision file received by client node 1 20a from 
server node 1 10. The revision thereby propagates through the communications network via the first, second and thiid 
nodes thereof. 

In a related embodiment, the status report generated by client node 1 20a may be transmitted from client node 120a 
to sender node 1 10 at a first time, whereas the status report generated by client node 130a may then be transmitted 
from client node 130a to client node 120a at a second time. The second time may advantageously be subsequent to 
the first time by a period of time sufficient to allow client node 120a infomiation to be fully revised before client node 
120a transmits the revision to client node 130a. A further aspect of the present invention therefore is allowance of 
orderly •^waves•' of revisions to propagate through communications network 100. In alternate embodiments, revisions 
may suitably be distributed in a more random fashion, as one node determines that another node requires a re/isionj 

An advantageous application of the present invention is to subscriber-based software distribution systems. "Sub- 
scriber-based systems." as the phrase is used herein, means electronic communications systems wherein a party, the 
"subscriber." contracts with a vendor, distributor, licensor or the like to receive and pay for a certain number of issues, 
versions, or the like of a particular software package, group of software packages, electronic sen^ices, or the like. More 
particularly, at least one of server node 1 10 or client node 120a includes memory for storing a subscriber list, associat- 
ing subscribers with their subscribed to services. Server node 1 10 and client node 120a transmit revision files, at least 
in part, as a function of the content of the subscriber list. The present invention therefore may suitably form the core of 
a fee-based update service, wherein subscribers pay for revisions. The amount of information revised and the fre- 
quency of the revisions may be selectable, allowing a range of fee-based services to be offered. In a related embodi- 
ment, the subscriber list is associated with a restricted list. The restricted list, when suitably processed in association 
with the subscriber list, identifies a subset of the information of the subscriber list that is available or unavailable to a 
particular user or group of users, such as a group of users associated by geographical location, for example. The 
restricted list may therefore functions as a filter for the subscriber list. 

The propagation of updates through a subscriber-based systems may be particularly advantageous, not only over 
WANs, such as the Internet, but also through cable television systems, such as those providing pay-per-view and 
demand-television, including emerging services for receiving video games and other interactive services. 

From the above, it is apparent that the present invention provides a system, and method of operation, for propagat- 
ing revisions through a communications networK wherein the communications network includes a plurality of associ- 
ated nodes. The system includes: (1) status reporting circuitry, associated with a second node of the communications 
network, for collecting and transmitting a cun-ent status of second node information stored in a memory of the second 
node. (2) first information revising circuitry associated with a first node of the communications network, for receiving the 
current status from the second node, determining as a function of the current status whether a revision of the second 
node information is required and, if the revision is required, transmitting the revision to the second node to revise the 
second node information and (3) second information revising circuitry, associated with the second node of the commu- 
nications networK for receiving a current status from a third node of the communications network, determining as a 
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function of the current status from the third node whether a revision of third node information stored in a memory of the 
third node is required and, if the revision Is required, transmitting the revision received from the first node to the third 
node to revise the third node information, the revision thereby propagating through the communications network via the 
first, second and third nodes thereof. Revisions are therefore allowed to propagate automatically through a communl- 

5 cations network, wherein various nodes within the communications network are responsible for both detecting when a 
revision to information in another node is necessary and transmitting the revision to the other node. 

The broad scope of the present invention is not limited to tree-based hierarchical networks of the type set forth in 
FIGURES 1, 4 and 5, but also includes other conventional networks configurations, such as peer-to-peer communica- 
tions networks. The propagation of revisions is also not limited to a first node to a second node to a third node progres- 

10 sion, but rather Includes revision of a first node propagated to one or more second nodes, from at least one of the one 
or more second nodes to one or more third nodes, from at least one of the one or more third nodes to one or more fourth 
nodes, etc., thereby enabling not only the sequential revision of serially associated nodes, but also a hierarchical fan- 
out updating of a plurality of nodes. 

The present Invention Is also not limited to pure "computer-based" communications networks, such as LANs or 

75 WANs, but may also suitably be Implemented in telecommunication systems to update system software or data or In 
wireless environments, such as cellular telephony or message paging networks. To that end, the principles of the 
present Invention may suitably be associated with any network element functioning as a node, Including routers, 
bridges, gateways, switches, or other conventional portal devices, satellites, relay stations, or the like. While the princi- 
ples of the present invention have been described In detail, those skilled in the art should understand that they can 
( make various changes, substitutions and alterations herein without departing from the spirit and scope of the invention 
in its broadest form. 
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APPENDTY a 

"SENDT TST " sormrF rnnr 



CMD =5 * bascnamc $0 ' 

USAGE«"Usagc: SCMD [ -d] [ -s scrvcriD ]" 



FCSHOK=no 
echo yes | read KSHOK 
if lest-SKSHOK" « * no"; then 

if test'S{RETRYlNG_KSH:-no}- « "yes": then 

echo "SCMD: ERROR: not running with kshSS » aborting!* 
15 echo "SCMD; ERROR: not running with tcshSS - aborting! • 

/bin/mail exptools 
RC«2 
eHftest$#-gtO: then 

RETRYING KSH-'ycs" SSHELL $0 '$<a" 
RC-S? 

20 eisc 

RETRYING KSH-'ycs' JS HELL SO 
RC = $? 

n 

exit SRC 

n 

25 

# < cmsg 

This routine prints oui error messages and mails them to exptools 

30 cmsgO { 

typeset MSG= "SCMD: ERROR: SI aborting!" 

cypeset LOG » $ ADMRUG/SS ER VERID/local/sendp 1 ist. ouc 

typeset ECODE ECMD 

if test -n "$2*; then 
35 echo $2 I read ECMD ECODE 

MSG-"$MSG\nError 'SECODE' reported by SECMD" 

fi 

echo -SMSG" >&2 
{ 

echo "Subject: scndplist error!' 
echo 

echo "SMSG" 

if test -s SLOG; then 

echo "\nHcre is the complete scndplist log file:" 
echo " r " 



pr -04 -t SLOG 
echo * 

fi 

} I /bin/mail exptools 



/f < extraciscction 

# This routine extracts given sections of input files that arc terminated by 
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tf the EOF line. 

cxiraccscctionO { 
integer secuon«$l 
cypcsct inputfilc-$2 
integer i = l 

typeset LINE done = false 

while not Sdone SlSl read LINE; do 
if ((i > section)); then 

done "true 
eiif test "SLINE" = •$EOF^ then 

((» += D) 
elif ((i = = section)); then 

echo 'SLINE- 

fi 

done < Sinputfile 



< mam 



GETOPT«$(getoptds: "$(©") 
if (($? != 0)): then 

echo •$ USAGE- 

exit 2 

fi 

set - SGETOPT 

#set -c ff Exit on any error 

debugs"' 
SERVERID=*" 
for arg in "S@"; do 

case "Sarg* in 

-s) 

SERVERID«$2 
shift 2 

^) 

debug-: 
shift 

") 

shift 
break 

esac 
done 

if test ! -f SADMRUa/global/config; then 
emsg 'Can't find RUG global config file" 
exit 2 

fi 

. SADMRUG/global/config 

if test -n 'SSERVERJD*; then 
FOUNDS false 
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for [D in SSERVERIDLIST: do 

iftcsc'SID' = "SSERVERiD"; then 
FOUND =» true 

fi 

done 

if not SFOUND: then 

cmsg "Unknown scrverid 'SSERVERID' given" 
exit 2 

ft 
else 

if test -z "SDEFAULTSERVERID"; then 
emsg "Default server id missing" 
exit 2 

n 

SERVERID = $DEFAULTSERVERID 

n 

exec > SADMRUG/$SERVERJD/local/scndpH$t.out2><Scl 
echo 'Start *datc"\n" 

20 CASC ADEFILE= SADMRUG/SSERVERJD/global/cascade 

if lest -f SCASCADEFILE: then 

cp SCASCADEFILE SADMRUG/local/cascadenie 
chmod 664 SADMRUG/Iocal/cascadcfiic 

n 

25 SAJDMRUG/giobal/linkconftg SSERVElRID 

NETINFO«S(echo SSERVERID STYPE | SNETCMD) 
if test -z "SNETINFO"; then 

emsg "Unable to acquire network information" 

exit 2 

fi 
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echo "Networking information: SNETINFO" 



tmppkglist /usr/tmp/SSpkglisi 
tmpplisi=/usr/tmp/$$piist 
35 impexcludc=/usr/tmp/$$excludc 
tmp ignore /usr/tmp/$$ignore 
mkperrs s= /usr/tmp/$$mkperrs 
crrfilc^/usr/tmp/SSerrfile 
tmpsubfiic=/usr/tmp/JSsubfiic 

tmpnist = "Stmppkglist Stmpplist Stmpexclude Stmpignore Smkperrs SerrfiJe Stmpsubfile" 

40 

retval-O 
trap ' 

retval= I 

exit 
• I 2 3 15 
45 trap * 

rm -f Stmpflisi 

exit Srccval 
' EXIT 



cd 

rm -f adm/updM/lib/cpio.ncw ff Remove emergency update list 

echo "\nCompuiing the subscription list ..." 
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{ 

echo "The SLOGNAME userid uses the alias '$LOCALCUE^f^D' to subscribe to the 
following STYPE tools from SSERVERID*:' 

cat SSUBSCRUST | # Combine *aU« subscr-list files 

CleanCocnm | 
scd 7*»/d' I 
sort -f > Stmpsubfile 
If test -s Stmpsubfile; then 

pr -04 -I -4 Stmpsubfile 

else 

echo "NONE!" 
fi 

cat SSUBSCRLIST [ # Combine «aU* subscr-list files 

CleanComm | 
scd'rpij/d; s/*!/r ( 
sort -f > Stmpsubfile 
if test -s Stmpsubfile; then 

echo* rejecting these tools:* 

pr -o4 -t -4 SCmpsubfile 

fi 

} > SADMRUG/local/subscriift 
^ chmod 664 SADMRUC/local/subscrlist 

echo "\nComputingchectesums...* 

( 

> Scrrfile 
25 > SmJcperrs 

{ 

cat SEXCLUDELIST ^ Combine *aa* exclude-lisi files 

gcnlinkdirs SSERVERID 
} I mksed > > Stmptgnore 

{ find . ! -name \- -print 1 1 echo 'find $?* > Scrrfile ;} | 
30 { scd -c 'si'X./!!' -f Stmpignore 1 1 echo "sed $7" > Scrrfile ;} | 

{ STADMRUG/bin/mkplist -m 2> Smkpcrrs | | 

echo "mkplist $?• > Scrrfile ;} | 
{ sort -u 1 1 echo "sort S?' >SerrfiIe ;} 

if test -s Scrrfile: then 

if test 'S Smkpcrrs; then 
35 cat Smkpcrrs >> SADMRUG/SSERVERID/locai/sendplist.out 

emsg 'Failure preparing client plisc report" "S( < Scrrfile)" 
exit 2 

else 

echo "SEOF" 

fi 

) > Stmpptist 
chmod 664 Stmpphst 
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eval S{dcbug:+*cp Stmpplisi SADMRUG/SSERVERJD"} 

if {($(TZ =OMT date + %H) < 2)); then JIf if before 2AM GMT 

integer WaITTIME- RANDOM % 1800 set la hour random delay 

echo -Nn Waiting SWAjnTIME seconds to prevent server overload" 
sleep SWATTTIME 

fi 

echo '\nScnding to SSERVERID' 
echo •SNETINFO" | 

Sdcbug SSENDCMD -u SSERVERID^LOGNAME -f rjc/SSERVERlD/SLOCALCUENTID.SYRDAY Stmpplist 
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> Scrrftlc 

cat SSUBSCRLIST | 0 Combine »all* subscr-Usi Hies 

CleanComm | 
sort -u 

echo -SEOF" 
{ 

cat SEXCLUDELIST # Combine *MI» exclude-list files 

^cnJinkdirs SSERVERID 

} I 

CleanComm | 
sort -u 

echo -SEOF' 

If test -z "SDEFAULTLCXTALID*: then 

echo '0:SLOCAJLCLlENTlD:$(unamc -n): SLOG NAME: $(uname -rvm)" 

else 

typeset LINKDIR»$ADMRUa/$DEFAULTLOCAi.ID 
typeset RJE-$HOME/rje/$DEFAULTLOCALID 

echo -O.SLOCAl-CUENTID/SDEFAULTLOCALIDrSCunflrae •n):SL.OGNAME.$(unamc -rvm)" 
if test -f SLINKDIR/scrver/exptab; then 
sort SLINKDUR/server/exptab 

ni 

while IFS-: read CLIENT REST; do 
If test -f SRJE/SCLIENT.pkg; then 
integer COUNT »0 
exiractsection 3 SRJE/SCLIENT.pkg | 
while IFS-: read COUNT CT ND UID OS: do 
25 ((COUNT +- I)) 

echo -$COUNT:SCT:$ND:$UID:$OS" 
done 

fi 

done 

fi 

30 echo 'SEOF* 

) > Simppkgiist 
chmod 664 StmppJcgitst 

eval ${debiig: + -cp Simppkgiist SADMRUO/SSERVERID") 

35 echo "SNETINFO* | 

Sdebug SSENDCMD -u SS ERVERID_^LOGNAME -frje/SSERVERlD/SLOCALCLIENTID.pkg Stmppkglisi 

if ( -s Smkperrs ]; then 
{ 

echo "Subject: mkplist enors on SLOCALCUENTIDVn" 
40 scd •s/"/$LOCAJLCUEhmD:sendplist:STYPE:/" Smlcpcrrs 

} I 

/bin/mail SSERVERMAIL 
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# Log the error messages 
echo 'Errors:" 
cat Smkperrs 

n 

rm -f /tmp/$h$S. I 
echo '\nFimsh 'date' * 
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"SENDUPDT " SOTIRCF. rODF 



CMD - ' basenamc SO ' 

USAGE= "Usage: $CMD [ -cdprR ) ( -1 locailD ) ( -t threshold ] client" 

KSHOK = no 
echo yes | read KSHOK 
70 if test -SKSHOK' = "no"; then 

if lest "${R£TRYTNG_lCSH:-no}" = "yes"; then 

echo "$CMD: ERROR: Not running with ksh88 -- aborting! " 
RC = 2 
el if test S# -gtO; then 

RETRYTNG K5H="yes" SSHELL $0 "$(©• 
15 RC«$? 
else 

RETRY1NG_KSH « >es* SSHELL SO 
RC = $? 

n 

exit SRC 
alias -X echo= "print 



25 ^ < c"»sg 

U This routine prints out error messages and mails them to exptools 
emsgO { 

typeset MSG ='$CMD: ERROR: SI - aborting!" 
30 typeset LOG = Sou tfile 

typeset ECODE ECMD 

if test -n "52"; then 

echo S2 I read ECMD ECODE 

MSG = -$MSG\n£rror SECODE* reported by JECMD" 

35 fi 

echo "SMSG" >&2 
{ 

echo "Subject: scndupdatcs error!" 
echo 

echo 'SMSG" 

if test -s SLOG; then 

echo "\nHcre is the end of the sendupdate log file:" 
echo ■ ' 



tail SLOG I pr -o4 -t 
echo " 

45 n 



} 



} I /bia/mail exptools 



0 < findclient 

50 # 

# This routine returns a list of machines of the type defined by the first arg 
nndclicmO { 
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machines cypew^Sl | sort 

} 



^ < clcanupclient 

# This routine removes old rje ftles for a destgoated client. 

cIcanupcliencO { 

typeset CLIENTID-Sl today-J2 
typeset rrapattern todayfile 



yr«'date ' + %y'* 
tasiyrs'cxpr Syr - T 

S{debug} rm -f $RJE/$CUENTID.${Iascyr}* $IUE/$CUENTID.diff» 
^5 rmpattcrn»-SRJE/$CUENTID ${yr}** 

todayfile- "$RJE/SCUE^mD.$today• 
for X in Srmpactern: do 

if test "Sx" !- "Stodayfiic* -a "Sx* !• "Snnpatiern*; then 
S{debug} rm Sx 

fi 

done 



20 



< dcletenies 

n 

25 # This command deletes files from a client 

deletefilesO ( 

Sdebug dctfile -V -p SEXPPKOrD -c -P SEXPPWD -M SSERVERMAIL "$<a- name^^SCLIEMTlD 

} 

XT < delctedirs 

# This command deletes directories from a client 
deletedirsQ { 

35 Sdebug rrmdir -v -p SEXPPKGID -c -P SEXPPWD Saltuid -M SSERVERMAIL 'S®* name- -SCLIENTID 

J 

U < senddclfiles 

^ # This routine sends the commands to delete files from a client 



senddelfilesO { 

typeset CLIE^r^D»Sl dtfnie*S2 

typeset pattern-**- \( *(*/]\)$* # ordinary (non-dir) file pattern 



if (( $(grcp -c 'Spancrn* Sdiffilc) > 0)); then 
echo "\tRcmove Hies:" 
sed -n 'siSpattern! \l!p' Sdiffile 

sed -n 'sISpattern'rm '\r*p- Sdiffile | 
( 

5^ U Do the standard setup 

echo 'HOME-*expr ■$0" : '\(.»\)/adm/bin/"^' 
echo '. SHOME/.cronprofilc' 
# Now get the user commands 
cat 
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) > Scmpcmdnie 

rex -cv -p SEXPPKGID -r priv -P 5EXPPWD Saltuid -M SSERVERMAIL -f Stmpcrndfilc name- -SCLIENTID 



# < sendchmods 

M This routine sends chmod commands to a chent 

sendchmodsO { 

typeset CUENTID-$1 difnic-$2 

typeset pattern -'*\((0-9)*\) \(.*\)$' # chmods file pattern 

if (( S(grcp < "Spattcrn* SdifTUe) > 0)). then 
echo '\tChange ftles:" 

scd -n 's!$pattern! M \2!p" SdifTiIe 

scd -n •$!$pattcrn!chinod \l '\2'»p' SdifTile | 

{ 

if Do the standard setup 

echo 'HOME-'expr . '\(.*\)/adm/bin/"^ * 
echo SHOME/.cronprofilc* 
If Now get the user commands 
cat 

} > Stmpcmdfile 

rex -cv -p SEXPPKGID -r pnv -P SEXPPWD Saltuid -M SSERVERMAIL -f Stmpcmdfile name- ^SCLIENTID 

ft 

25 ) 



— < sendrrmdirs 

if 

30 sendrrmdirsO { 

typeset CUENTID-$1 dirfile»$2 

typeset pattern - \(.*\)/$' # directory pattern 

if (( $(grcp -c •Spattern" Sdiffile) > 0)), then 
echo *\iRemove directory:" 
35 sed -n "siSpattern! M'p" Sdiffile 

sed -n *s!Spattern!-d'\r!p* SdifTtle | 
sort -r I 

xargs -$350 echo deletedirs | if echo the function we want 

eval *S(cat)* if exec constructed function 

n 



ff , — -«™. < sendrepfiles 
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sendrepfilesO { 

typeset CLIENTID-i$l difTile-Sl 

integer onemcg<- 1048S76 # number of bytes in a one meg file 
integer bsize if number of bytes in a bloclc on this machine 

integer limit H maximum size of cpio file in blocks 

typeset CPIOFLAGS # nags for cpio 

case S(machtypc) 

in ibm) bsize « 4096 tt ibm uses 4096-byte blocks 

pyr) bsize«2048 if pyr uses 2(H8-byte blocks 
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*) bsizc=5l2 # everyone else uses 3l2*bytc blocks 
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esac 

f(limi( = oncmeg / bsize)) # calculate the block size limit of files 
5 scd -n \(.*(V)\)/*\$!;\r!p' Sdiffile > Stmpclist 

if [ -s 'Stmpclist" ]; then 
integer sum »0 size 
echo '\tUpdaie files:" 
scd *s/^/ /■ Stmpclist 

> Stmpwlist 
10 xargs Is -sd < Stmpclist | 

{ 

CPIOFLAGS = --oc" 
if test "STYP" « 'mip"; then 
CPIOoexpcpio 

else 

CPIO=cpio 
if SSVR4; then 

CPIOFLAGS="-o -Hodc" 

fi 

fi 

while read -r size filename; do 
((sum « sum + size)) 

if [[ Ssum -gt Slimii SlSl -s Stmpwlist I); then 
SCPIO SCPIOFLAGS < Stmpwlist > Stmpcpio 
name^^SCLIErmD ^"^^^"^ SEXPPKCID < -P SEXPPWD Saltuid -M SSERVERMAJL -f Stmpcpio 

((sum = size)) 
> Stmpwlist 

25 fi 

echo "S filename" > > Stmpwlist 

done 

SCPIO SCPIOFLAGS < Stmpwlist > Stmpcpio 
^ Sdebug sendcpio -v -p SEXPPKGID ^ -P SEXPPWD Saltuid -M SSERVERMAIL -f Stmpcpio name= =SCLIENTID 

30 J 

ff < dirlog 

5^ dirlogO { 

typeset CUENTID= SI diffile«S2 

^ sed -n VVS/s%\(.*\).%^date +%y%m%d' \I %p- Sdiffile > > SLINfCDIR/ciicnt/SCUENTID/dirlog 
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^ < updlog 

n 

updlogO { 

. typeset CLIENTID = S I difnie= $2 

^ sed -n •AyS/!s%*%'date +%y%m%d* %p" Sdiffile > > SLINKDIR/clicnt/SCLIENTID/updlog 



n < piistOK 
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pliscOKO { 

typeset plistfile-'$l 
typeset RC 

tf test ! -f •$pHstfile*; then 
RC-I 

clif test '$(tail -I Splistfilc 2>/dcv/aull)' •= *$EOF'; then 
RC=1 

else 

RC-0 

n 

return SRC 

} 



# < pkgfiieOK 

# 

pKgnieOKO { 

typeset ptcgfile-SI 
typeset RC 

if test ! -f 'SplcgfiJe"; then 
RC-l 

cliftc$t"$(tail-l $pkgrilc2>/<lcv/nu]l)" !- "SEOF"; then 
RC-I 

else 

RC=xO 

n 

return SRC 

} 



ft < mlcioollist 

# This routine renirns a full list of the tools subscribed to in the file 

# given as argument. 

mktoollistO { 
typeset RC 

> Serrfile2 M begin with no error condition 

> Stmpsubscr2 # begin with no cool list imtiaUy 
for subfile, do 

# eliminate comments and blank lines 

{ CleanComm < Ssubfile 1 1 echo *CleanComm J?" >$errfae2 ;} | 
if get excluded toot names 

{ sed 'H^O/d: s/"!/r | ) echo "scd $?' >$crrfilc2 ;} | 

# expand any metanames 

{ expandtools 1 1 echo *expandtooJs $?* >SerrfiJe2 ,} | 
0 sort the list 

{ sort-u > Stmpcxclude | ( echo "sortS?* > $errrile2 ;} 
if test -s Serrrile2; then break: H ff Break out of loop on error 
n move previous cool list 

{ mv Stmpsubscr2 Stmpsubscrl 1 1 echo "mv $?• >$crrrilc2 .} 
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if test -s SctrfileZ; then break; fi » Break out of loop on error 
n elimittate comments and blank lines 

{ CtcanComm < Ssubftle 1 1 echo "ClcanComm $?* >$errnie2 ;} | 

U get subscribed tool names 

{ scd 7"t/<I' 1 1 echo "scd $?" >$crrnic2 ;) | 

U expand any mecanaxnes 

{ expandtools 1 1. echo 'expandtoots %V >Serrflle2 ;} { 
H add previous tools and sort them 
{ son -u - Stmpsubscrl | | echo "sort $?* >$errrile2 :} | 
# remove the excluded names 

{ comm -23 - Stmpcxcludc > $tmpsubscr2 | | echo "comm $?" >$crrrilc2 :) 

if test -s Serrfilc2; then break; fi tf Break out of loop on error 
done 

if test -s $errnie2; then 

read ECMD ECODE < Scrrfile2 

echo "SO: Error SECODE* reported by SECMD'" >&2 
RC=$ECODE 

else 

cat $tmpsubscr2 U return the final list 

RC=0 

n 

remrn SRC 

} 



If _ < extractsection 

n 

tf This routine extracts given sections of input files that are terminated by 
the EOF line. 

extracisectionO { 
integer section »$1 
typeset iaputrile=sS2 
integer i» 1 

typeset LINE done« false 

while not Sdone ScSc read LINE; do 
if ((i > section)); then 

done»true 
clif test'SLINE- =« "SEOF"; then 

(0 1» 
elif ((i a = section)); then 
echo "SLINE" 

n 

done < Sinputfile 



ff < mail news 

mailnewsO { 

typeset NEWSTEME^SHOME/.matlnewsjimc NEWSDIR-SADMRUG/news 

iftest -dSNEWSDIR -a -n "$*"; then 
cd SNEWSDIR 
for file in $(ls -tr); do 

if test snic -nt SNEWSTIME; then 
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echo 'VtAnnouncmcnt 'Sftle' mailed to S*" 
( 

echo "Subject: Expcools announcement" 

echo 
. cat Sfile 
} I /bin/mail $* 



fi 

done 
cd - 

n 

touch SNEWSTIME 

} 

ff < salutation 

salutationO { 
^5 if not SSALUTATION: then 

SALUTATION = true 



ft EJtptools Adminis rator of server SLOCALID. 

} 



< clientsort 

# This routine sorts clients based on the depth and number of m&chinc in the 

cascade they serve. This allows clients who have deeper and more numerous 
ff cascades to get their tools first and begin serving them sooner. 

clientsortO { 
typeset CL 

integer DEPTH MAXDEPTH MACHCOUNT WEIGHT 
for CL: do 

50 typeset PKGnLE=$HOME/rjc/$LOCALID/5CL.pkg 

MAXDEPTH^O MACHCOUNT=0 WEIGHT^O 
if test -fSPKGFlLE; then 
excractsection 3 SPKGRLE | 
while IFS=: read DEPTH REST; do 

if ((MAXDEPTH < DEPTH)); then 
35 ((MAXDEPTH = DEPTH)) 

fi 

if ((DEPTH D); then 
((MACHCOUNT 1)) 

fi 

done 

((WEIGHT « MAXDEPTH + MACHCOUNT/4)) 

Ti 

echo "SWEIGHT SCL" 

done I 

sort -l-O-lnr +1 I 
while read DEPTH CL; do 
echo "SCL" 

45 done 
} 



ff < main 

SO 
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autoload take 
cd 

GETOPTs$(gctopicdprRl:t: "S^*) 
if((S?!=0)); then 

echo -$US AGE* 

exic 2 

fi 

sec SG ETOPT 

debugs" 
LOCALID-" 
RESEND- false 
CHECKSUMS -false 
USEPUST- false 
NULL MEANS ALL » true 

S{THRESHOLD:«200} 
for arg in "5(9'; do 

case "Sarg' in 

-c) 

CHECKSUMS -true 
shift 

•d) 

debug » echo 
shift 

•f) 

RESEND-truc 

NULL MEANS_ALL« false 

shift 

RESEND^true 
shta 

-P) 

USEPLIST-truc 
shift 

-0 

THRESHOLD « $2 
shift 2 

•i) 

LOCALID-$2 
shift 2 

") 

shift 
break 

esac 
done 

CUENTLIST-"$(»* 

tf test ! -f SADMRUO/global/coafig; then 

echo "SCMD: ERROR: Can't find RUG global config file" 
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exit 2 

fi 

. SADMRUG/giobal/config 

if test -n ^SLOCALID"; then 
FOUND= false 

for ID in SDEFAULTLOCALID SLOCALIDLIST; do 
if test "SID" = 'SLOCAJLID": then 
FOUND = true 

fi 

done 

if not SFOUND; then 

echo "SCMD: ERROR: Unknown local server ID 'SLOCALID' given - aborting!* 
exit 2 

fi 
else 

' if test -z "SDEFAULTLOCALID"; then 

echo "SCMD: ERROR: Default local setter ID missing - aborting!' 
exit 2 

n 

LOC ALID = SDEFAULTLOCALID 

ft 

, SADMRUG/global/Iinkconfig SLOCALID 

outfile = SLINKDIR/servcr/update. out 

if test $(rtnd Soutfilc -mtime + 1 -print | wc A) -ne 0; then 

SENDUPDATES_DORMANT=true 0 Scndupdates has been asleep! 

else 

SENDUPDATES DORMANT= false # Scndupdates running as usual 

fi 

Sdebugcvai "exec > Soutfilc 2>&l" 
echo "Start 'datc*\n" 

EXPTAB = $LINKDIR/server/exptab export EXPTAB 

EXPPKGID = SLOCALID 

RJE = S HOME/rje/$ LOC ALID 

NEWnLES = SHOME/adm/upd 1 . 1 /lib/cpio . new 

NEWFILESCOPY= $HOMR'adm/upd I . I /lib/cp io. ncw2 

: S{tnip: =/usr/tmp} 

tmpC ignore =Stmp/SSCignore # List of files to ignore from Client 

impSignorc=Stmp/$$Signorc if List of files to ignore from Server 

tmpignfilesStmp/SSignfile ff Work file of files to ignore 
tmpdtff«>Stmp/SSpdiff ^ List of files to change on client 

tmpclist=Simp/SSclist tf List of files to cpio to client 

tmpplist-Stmp/SSpttst # Sorted, uncommented client plisc 

tmpwltst=Stmp/$SwIist P List of files tt size limit to cpio 

tmpcpio=$tmp/$$cpio 0 Cpio file to send to client 

tmpexclude^Stmp/SScxcl # Work list of excluded toots 

tmpsubscr 1 =Stmp/$Ssubl if Work list of subscribed tools 

tmpsubscrl'sStmp/SSsubZ # Work list of subscribed cools 

tmpCNTmodcl-Stmp/SSCmodcl * Names of files desired by client 

tmpCNTplist^Strop/SSCplist # Client plist with excluded files removed 

impSRVtools=Stmp/SSStools # List of tools offered 

cmpSRVplist»Stmp/SSSplisc if Plist of files offered to client 

tmppkgfileaStmp/SSpkgfile # Work file of packages client subscribes to 
tmpfiles = Stmp/S$files # Work file of file names 

tmpcmdfile=Stmp/SScmds # Work file for commands to be sent 

crrfiles=Stmp/S$erTfile Flag file for detecting errors in pipes 
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crrnic2 = $tmp/$$crrnic U Flag Hlc for detecting errors in pipes 

tmpnist = -StmpCignore StmpSignore Stmpignnic Stmpdiff Stmpclist Stmpplist Simpwlist Scmpcpio Stmpcxcludc StmpCNTmodel 
StmpCNTplist SimpSRVtools SinipSRVplist StmppkgfUe Stmpftlcs Stmpcmdfilc Stmpsubscrl Stmpsubscr2 Scrrfile Scrrrllc^- 
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rcrval=0 
crap ' 
rervai=l 
exit 

trap * 

trap - ERR 
cmsg 'Error code Srcrval detected" 
exit Srerval 
' ERR 
trap ' ■ 

Sdcbug rm -f Stmpflist 
75 { 

echo 'Subject: $LOC,\LID gateway runlogNn" 
cat Soutfile 

} I 

Sdcbug /bin/mail $ADMIN_EMAIL 
exit Sreival 

20 

if SSENDUPDATES_,DORMANT; then 

echo '•****«***«»*»«***«««««*««*«**«**»«**«*«*»*»******«**»«**• 
echo 'WARNING: Scndupdates has not been run for over 48 hour$!\a" 
echo "*********»********•««*«***«««****»**«**«****«**««***»««*• 

fi 

SRVplist=$LINKDrRyserver/plisc.$yRDAY 
SRVnist-SUNKDIR/scrver/nist 
for file inSLINKDIR/scrvcr/plist.*; do 
if [ 'Sfile- !« 'SSRVpUst- J; then 
rm -f Sfilc 

fi 

done 

if test -z "SCUENTLIST" && SNULL MEANS_ALL: then 
CLIENTLIST= * findciient STYPE^ ~ 

fi 

echo "Clients: 
SCUENTLIST- 

if SRESEND: then 

for CUENTID in SCUENTLIST; do 

CUENTID=$(take 8 SCLIENTID) 
40 EXPPWD=$LINKDIR/cJieni/$CUENTID/.pwd 

if test -s SUNKDIR/clicnt/SCUENTID/uidnamc; then 

altuid«» SLINKDIR/cUent/SCLIENTID/uidnamc)" 
else 
altuid« 

fi 

45 impdiff=$RJE/$CLIENTID-difr 

SUSPENDED^ SUNKDIR/clicnt/SCLIENTID/Suspcndcd 
if test ! -f Stmpdiff; then 

echo "\n-"> No diff file found for SCLIENTlDVa" 
ciif test -f SSUSPENDED <SuSc $NULL_MEANS_ALL: then 

echo •\n™> Client SCLIENTID currently suspended' 
else 

50 
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cc«'wc -I < StmpdifT 
if [ "$cc" -«qO 1; then 

echo "\n\cNo updates for $CUE^mD• 

else 

echo "\n\tChangcs for SCLIENTID: " Sec 
senddelftles SCUENTID Stmpdtff 
sendmodtrs SCLIENTID StmpdifT 
sendctinnods SCLIENTID StmpdifT 
sendrcp files SCLIENTID StmpdifT 
dirJog SCUENTID StmpdifT 
updlog SCUENTID StmpdifT 

n 

n 

done 

elif SU5EPL[ST 1 1 SCHECKSUMS 1 1 not ptistOK SSRVptisr, then 
{ 

cat SEXCLUDEUST 

geiUinkdirs SLOCALID 
} I mksed -w > StmpS ignore 
if SUSEPUST; then 

echo *VaAcceptiDg curreat cbecAcsums ...* 

else 

echo "XiiCreating upward cascade map' 
UPDLOG -$TOOLS/adm/upd I . l/lib/updlog 
CPtOLOG-STOOLS/adm/updl . 1/lib/cpio.log 
TZ»$OLD TZ dale | read X X X X TIME20NE REST 
MONTH -"date- 
day -"UNKNOWN !• 
TIME-"- 

if test -f SCPIOLOG -a ! -f SADMRUG/.ovcn then 

T2-SOLD T2 Is -1 SCPIOLOG | read X X X X X MONTH DAY TIME REST 
TIME-'STTME STIMEZONE' 
elif test -TSUPDLOGi then 

T2»$6lD TZ Is -I SUPDLOG | read X X X X X MONTH DAY TIME REST 
TIME - "STTME STIMEZONE' 

n 

integer LEVEL 

CASCADEFtLE=$UNKD[R/g!obaI/cascade 

ccho"l:$LOCAUD:$MONTH$DAY$TIME' > SCASCADEHLE 
for ID m SDEFAULTSERVERID SSERVERIDUST; do 
if test -f SADMRUG/SID/global/cascade; then 

while IFS- : read LEVEL SERVER TIMESTAMP: do 
((LEVEL +- I)) 

echo -SLEVEL:SSERVER:$TIMESTAMP'' 
done < SADMRUG/SID/global/cascade > > SCASCADEFILE 

fi 

done 

chmod 664 SCASCADEFILE 
cat SCASCADEFILE 

echo '\nCreattng downward cascade map* 

{ 

echo 'VoNOTE: This cascade map generated S(datc)* 
showtree -I $LOC/*J-lD 
} > SLINKDIRyiocal/cascade 

echo '\nCheclcing on exp tools announcements* 

< 

LOCAL /VDMIN EMAIL-SADMIN EMAIL 
if test -n' SDEFAULTSERVERID"; then 

. SADMRUC/global/iinkconfig SDEFAULTSERVERID 
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server_admin_email=sadmin_email 

else 

SERVER ADMIN EMAIL='* 

5 " " 

if test -$LOCAL_ADMIN,EMAlL' !« "SSERVER ADMIN EMAIL"; then 
mailncws SLCKIAL ADMIN EMAIL 

fi 

) 

echo "\nCalculating new checksums ..." 

rm -f SRJE/UpdatcStartcd $RJE/UpdateEnded $RJE/RequcstEnded SerrfUe 

mktoollist SSUBSCRLIST 1 1 echo "mJctooUist $?- > Scrrfile 
} > StmpSRVtools 

^5 if test -s Serrfile; then 

emsg "Failure preparing server tool list' "$(< Serrfile)" 
rm -f StmpSRVtools 
exit 2 

n 

20 '^^ ! -s StmpSRVtools: then 

echo "SCMD: ERROR: No tools being served by this server - aborting!" 
exit 2 

a 

if not fgrep -x updtools StmpSRVtools >/dev/nuU 2>&l; then 
25 ^^^^ 'SCMD: ERROR: Essential tool * updtools' not being served - aborting'" 

exit 2 • , 

fi 
{ 

# Get fiicnamcs for tools served 

30 { TOOLS «$HOME $TOOLS/adm/updl, l/bin/prpkg -ir < StmpSRVtools 1 1 

echo -prpRgS?" >$errrile:} | 

# Put in sorted order 

( sot^ I I echo "sort S?" > Serrfile ;) | 

0 Add directories to complete list 

{ $TADMRUG/bin/dirnilout 1 1 echo "dirfillout $?" > Serrfile ;} I 

35 ^ Remove server- ignored files 

{ scd -f StmpSignorc 1 1 echo "sed $?" > Serrfile ;} | 

# Get plist data for given files 

{ time STADMRUG/bin/tnkplist -m | | echo "mkplist $?" > Serrfile ;} | 

# Put tn sorted order 

{ sort -u j I echo "sort $?" > Serrfile ;) 

40 echo "SEOF" 

} > SSRVpltsi 

if test -s Serrfile; then 

emsg "Failure preparing server checksums" "S(< Serrfile)" 
exit 2 

45 fi 
fi 

if not plistOK SSRVplist; (hen 

echo "SCMD: ERROR: Corrupted plist file SSRVplist* - aborting!" 
exit 2 

fi 

^0 SNEWFILES # Remove previous list of new files 

if notSUSEPLIST; then 

> SRJE/UpdatcStarted 

fi 
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OVERTHRE5HOLD= false 
LONCTERMPROB = false 
MISS lNGREPORT= false 
SUBSCRJBE^ERROR = false 
^ echo "\nCurrcnt update threshold: STHRESHOLD" 

echo -NnThc clients below arc processed according to the sizes of their cascades/ 
echo 'largest first," 

for CLIENTID in $(clicntsort SCLIENTLIST); do 
CUENnD = $(take 8 SCUENTID) 
cleanupclicnt SCLIENTID SYRDAY 
10 SUSPENDED^SLINKDIR/cticnt/SCLIENTlD/Suspcndcd 
if test -f SSUSPENDED: then 

echo "\n — > Client SCLIENTID currently suspended" 
else 

EXPPWD = $LINKDIR/cIient/$CLIE^n^D/ .pwd 
if test -s SLINKDIR/client/SCUENTID/uidnamc; then 
15 alniid-"-uS(< SLINKDIR/clicnt/SCLIENTTD/uidnamc)" 

else 

altuid» 

fi 

Chn*piist=$RJE/$CLIENnD.$YRDAY 

CMTpkgrUe^SRJE/SCLIENTID.pkg 
''^ if not plistOK SCNTpHst; then 

' if test ! -f SCNTplisc then 

MISSINGR£PORT==true 

echo "\n'-> No plist file found for SCLIENTIDVa" 

integer DA YSOLD=0 

if test ! -f SCNTpkgfile; then 

echo " No package file found for SCLIENTID" 
elif not $SENDUPDATES_DORMANT test -z "SCfind SCNTpkgfilc -mtimc -3 -print 2> /dcv/null)"; then 

DAYSOLD=4 

while test -n "${find SCNTpkgfilc -mtimc +$DAYSOLD -print 2 > /dcv/nuU)"; do 

((DAYSOLD 1)) 
done 

((DAYSOLD D) 

echo • This client hasn't reported for SDAYSOLD days!" 

fi 

if ((DAYSOLD !» 0)); then 

ADMlNDATA«$LrNKDIR/clicni/$CLIENTID/admindata 
if test -f SADMINDATA; then 
typeset NAME EMAIL 
35 while read HELD VALUE; do 

case "SFTELD" 

in NAME) NAME- "SVALUE" 

;; EMAIL) EMAIL= 'SVALUE' 

csac 

done < SADMINDATA 

if [[ "SEMAIL* @(nonciNONE|--) ]]; then 
{ 

echo "Subject: exptools errors" 
echo 

if {[ "SNAME" !=- @<nonc|NONEr") ]); then 
echo "To SNAME:- 

45 

fi 

echo "The RUG update code has detected an error. Your client * SCLIENTID' has not" 
echo "reported to its seivcr * JLOCALID* for the last SDAYSOLD days. Please check" 
echo "your system to see what is causing this problem. Consult the 'rugadm' HELP" 
echo 'subsystem for advice. The 'rugchcck' command may also be helpful" 
echo "in identifying the cause of this problem." 
echo 
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echo "XtXtMMSLOCALID Expiools update routine* 
} I mail $EMA1L 

echo • Warning notice sent to $ EMAIL. ' 

else 

echo ' No admimsirator email address on file for 'SCLIENTID* . * 

echo " Warning notice NOT SENT to that roachinc's Exptools admimsirator. " 

n 

fi 

if ({DAYS0LD%5 0)); then 
{ 

echo "Subject: txptools client trouble* 
echo 

echo "The RUG update code has detected an error. The client 'SCLIENTID' has not* 
echo "rcponcd to its server '$LCX:ALn)* for the last SOAYSOLD days. Please contact" 
echo "the exptools administrator of that system to see what might be causing this" 
echo "problem. You can consult the 'rugadm' HELP subsystem for advice.* 

echo 

echo *\t\t\t\t$LCX:ALlD ExptooU update routine" 
} I mail SAJDMIN^EMAIL 

echo * Warning'notice sent to $ ADMIN EMAIL.* 

n 

else 

echo "\n — > Corrupted plist file found for SCLIENTIDXa'' 

fi 

eiif not pkgfileOK SCNTpJcgfile; then 
If test ' -f SCNTpkgfile; then 
MISSlNGREPORT-tnie 

echo "Xn — > No paclcage file found for SCLIENTIDVa* 
else 

echo '\n — > Corrupted package file found for SCLIENTlOXa' 

fi 

el&e 

echo '\nProccssing SCLIENTID ^date' * 

sleep 10 Allow other processes to be cleaned up 

> Scnfile 

If test * -f StmpSRVtools; then 
{ 

tnktooltUt 5SUBSCRLZST 1 1 echo "rnktoollistS?" >Serrfile 
} > StmpSRVtools 

if test -s ScrrTile; then 

cmsg "Failure preparing server tool list' '$(< Serrftle)" 
rm -f StmpSRVtools 
exit 2 

fi 

if test ! -s StmpSRVtools; then 

echo "$CMD: ERROR: No tools bemg served by this server - at>orting!* 
exit 2 

fi 

if not fgrep -x updtools StmpSRVtools >/dev/null 2>&l, then 

echo *SCMD: ERROR: Essential tool 'updtools* not being served - aborting!* 
exit 2 

fi 

fi 

extractsecttoa 1 SCNTpkgfile > Stmppkgfile 
extractscctton 2 SCNTpkgfile | 
mksed > StropCignore 
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if test ! -5 Stmppkgfilc; then 

echo 'SCMD: ERROR: No tools being requested by this diem - skipping*' 

SUBSCRJBE^ERROR = true 

continue 



if not fgrep -x updiools Stmppkgfile >/dev/nulI 2>SlI; then 

echo "SCMD: ERROR: Essential tool 'updtools' not requested - skipping*" 
SUBSCRIBE ERROR = truc 



continue 

n 



{ 

# Get tools subscribed to 

{ mktoollist Stmppkgfilc 1 1 echo "mkiooltist $?" >$errnie ;} | 

# Intersect with offered tools 

{ comra -12 - StmpSRVtools 1 1 echo "comm $?" >$crrfilc ;) | 

# Get filenames 

{ TOOLS = $ HOME $TOOLS/adm/upd 1.1 /bin/prpkg -ir | | 

echo "prpkg $?■ >$errnie ;} | 

# Put in sorted order 

{ sort -u I I echo "sort $?" >$€rrrile ;} | 

# Add missing dirs to list 

{ STADMRUG/bin/dirfillout 1 1 echo "dirfiilout $?" >$errriic;} | 
^ Remove client-ignored files 

{ scd -f StmpCignore | | echo "scd $?" >$errfilc ;} | 

# Put in plist form w/o csums 

{ $TADMRUG/bin/mkplist -c | | echo •mkpIistS?" >$errfile ;} | 

# Put in sorted order 

{ sort -u 1 1 echo 'sort $?" >$errfile ;} | 

{ /usr/bin/join -j 1 -t' ' - SSRVpUst j ( 

echo "join $?" >Scrrfile ;} 

} > StrapCNTmodcl 

if test -s ScnTiIc; then 

emsg 'Failure analyzing client SCLIENTID checksums" "S(< Serrfile)* 
continue 



if test ! -s StmpChfTmodel; then 

echo "SCMD: ERROR: No files being requested by this client - skipping!" 

S UBSCRJB E_ERROR « true 

continue 



CleanComm < SCNTplist | Clean out any comments 

sort -u > Stmpplist # Make sure the file is sorted 

cut -fl Stmpplist I # Get the client filenames 

scd -f StnipSignore | # Remove sctver-ignored files 

/usr/bin/join -j I -f ' - Stmpplist > StmpCNTplist 

$TADMRUG/bin/diffplisi -m StmpCNTmodel -s StmpCNTplist > Stmpdiff 

PROBFILE«$RJE/.prob.SCUENTID 

cc«*wc -I < StmpdifT 

if fgrcp -X -c .profile" Stmpdiff >/dev/null 2>&1; then 

echo "SCMD: ERROR: Update requests for this client corrupted - skipping!" 
elif ( -Sec" -gt STHRESHOLD J; then 

echo "\i > Too many updates for SCLIENTID: Sec - skippingVa" 

if test *f SPROBFTLE; then 

if test -z "$(find SPROBRLE -mtime -3 -print 2>/dev/nulI)*; then 
integer DAYSOLD = 4 
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while test -n "S(find SPROBFFLE -mtimc +SDAYSOLD -print 2> /dev/null)-- do 
((DAYSOLD D) 

done 

5 ((DAYSOLD -= D) 

if ((DAYSOLD > 7)): then 

LONGTERMPROB » true 
STARS = "*«* ' 

else 

STARS = ''" 

10 fi 

echo "\t ${STARS}This client has been over threshold for SDAYSOLD days!' 
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else 



fi 

> SPROBRLE 

O VERTHRES HOLD = true 



15 fi 

elif ( "Sec" -eqO ]; then 
rm -f SPROBFTLE 

echo "XtNo updates for SCLIENTID" 
else 

rm -f SPROBRLE 

20 echo "\tChanges for SCLIENTID: ' Sec 

scnddelfiles SCLIENTTD Simpdiff 
sendrrmdirs SCLIENTID Strapdiff 
sendchmods SCLIENTID Stmpdiff 
sendrcpfiles SCLIENTID Stmpdiff 
dirlog SCLIENTID Stmpdiff 
updiog SCLIENTID Stmpdiff 

fi 

cp Stmpdiff SRJE/SCLIENTID.diff 

fi 

n 

done 

3^ SAl.UTATION = false 

if SOVERTHRESHOLD: then 
salutation 
cat < <-! 



Some systems have EXCEEDED the nightly update threshold. Systems with more 
than STHRESHOLD changes will not be updated except through the express approval 
of the exptools administrator. Sec the rugadm HELP screen "Approving the 
resending of update files to client machines" to see how to issue such an 
approval. 

40 ***************************«***«*»****«******«*«**********.**«•******»»*,*,.. 

j 

fi 

if SLONGTERMPROB; then 
salutation 
cat < < -! 

45 

Some systems have been over threshold for 7 days or more! Please determine 
why these systems have not gotten their updates. 

I 

50 fi 

if SMISSINGREPORT; then 
salutation 
cat < < -! 
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15 



Some clients did not send in their nigbtJy reports in time to be included in 
today's update processing. See the rugadm HELP screen "ChecJcing on client 
reports" for tips on how to handle this problem. 

«««««««»*«««»««**««««**«*«»»««««**«*«««»«««*«**«**«*«»»«««««****««***«««»**«» 

I 

n 

if SSUBSCRIBE_ERJlOR; then 
saluianon 
car < <-l 

Some clients have problems with their subscription lists. See the rugadm 
HELP screen "Understanding RUG ERKOR messages" for tips on how to handle this 
problem. 

I 

fi 

if notSUSEPLIST; then 

> SRJE/UpdateEnded 

n 

elif test -s SNEWFILES; then 

echo '\nScnding out newly arrived files ..." 
cp SNEWFILES SNEWPTLESCOPY 
{ 

cat SEXCLUDELIST 
gcnlinkdirs SLOCALID 
} I mlcsed -w > StmpSignore 
for CLIENTID in SCLIENTLIST: do 

EXPPWt> = $LlNKDIR/clicnt/$CLIENTID/.pwiJ 
if test -s SLINKDIR/clienc/SCLIENTID/uidnamc; then 

almid«''-uS(< SLINKDIR/ciieht/SCLIEhmD/uidnamc)" 
else 

altuid=> 

fi 

CNTpkgfile^SRJE/SCLIENTID.pkg 
if notpkgfilcOK SCNTpkgfilc; then 
if test ! -f SCNTpkgfilc; then 

echo "\n — > No package file found for SCLIENTIDVa" 

else 

echo "\n — > Corrupted package file found for SCLIENTIDU" 
fi 
else 

echo '\nProcessing SCLIENTID 'date*" 
> Serrfile 

y if lest ! -f StmpSRVtools; then 

{ 

mktoollist SSUBSCRLIST | | echo "mktooUist $?' >$crrfilc 
} > StmpSRVtools 

fi 

45 if test -s Serrfite; then 

cmsg "Failure preparing server tool list" '$(< Scrrfile)" 
rm -f StmpSRVtools 
exit 2 

fi 

SO if test ! -s StmpSRVtools; then 

echo "SCMD: ERROR: No tools being sctvcd by this server — aborting!* 
exit 2 

fi 
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extractsecuon 1 SCrrrpkgfilc > Stmppkgfile 
extractscction 2 SCNTpkgfile ) 

mJcjcd > StmpCignorc M Client- ignored files, scdscr 

if test ! -s Stmpplcgfile; then 

echo "SCMD' ERROR: No tools being requested by this client - skipping!* 
continue 

fi 

sed -f StmpCignorc SKEWFILES | Remove client-ignored files 
TOOLS -SHOME STOOLS/adm/upd I , l/bin/pkgpaih -a | M Get toolnamcs 
son -u > SimpCNTmodcl Sort new tooUftle list 



Gee tools subscribed to 
{ mkioollist Stmppkgfile 1 1 echo 'mktooUist S?* >$errftle :} | 

# Intersect with ofrered tools 

{ comm -12 - SimpSRV tools 1 1 echo 'comm 5?" > Serrfilc .} | 
U Put tn sorted order 

{ son -u 1 1 echo "sort $?' > Serrftle ;} | 

# Join with new tool: file list 

{ /usr/bin/join *t: • StmpCNTmodet ) | 

echo "join $?' >$crrfile ;} | 

ff Extract the file names 

{ cui-d: -fZ I I echo "cut $?" > Serrfilc ,| | 

# Put in sorted order 

{ son -u 1 1 echo 'sort $?* > Serrfile :} | 

if Put in update form 

{ sed •s/.»/+ &/• 1 1 echo *scd $7" > Senrfilc \\ 
) > StmpdifT 

if test -$ Serrfile: then 

emsg "Failure analyzing client SCUENTID checksums" "$(< Serrfilc)* 
comtaue 

fi 

cc-'wc -I < Stmpdifr 
if [ "Sec" -eqO ); then 

echo ^\iNo updates for SCLIENTID" 

else 

echo "VtChangcs for SCLIENTID: ' Sec 
scndrepfiles SCLIENTID StmpdifT 
updiog SCLIENTID StmpdifT 

fi 

cp Stmpdiff SRJE/SCLIENtlD.difn 

fi 

done 

if cmp -s SNEWFILES SNEWFILESCOPY; then 
rm SNEWFILES SNEWFILESCOPY 

else 

comm -13 SNEWFILES SNEWFILESCOPY > Stmpfilcs 
mv Stmpfilcs SNEWFILES 
rm SNEWFILESCOPY 

fi 

else 

echo *\nNo reason to send files, none will be sent!" 



echo "XnFinish *datc* " 

Sdcbug cat Soutfile > > SLINKDIR/scrvcr/Runlog 
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Claims 

1 . A system for propogating revisions through a communications network, cqmprismg: 

5 Status reporting circuitry, associated with a second node, of said communications .network..Jor collecting and 

transmitting a current^status of second node information stored in a memory of said second node; 

first information revising circuitry, associated with a first node. of said communications network,^ for receiving 
saic^currj,nt„statusJrom said-secon^^ as a function of said current status whether a revision 

10 of said second node information is required and, if said revision is required, transmitting said revision to said 

second node to revise said second node Information; and 

second information revising circuitry, associated with said^gond-node of-said.^jo,mmunications.iriet^^ for 
receiving a current status from a third node of said. communications network, determining as a function of said 
15 current status from said third node whether a revision of third node information stored in a m^ third 

node is required and, If said revision is required, transmitting said revision received from said first node to said 
third node to revise said third node information, said revision thereby propagating through said communica- 
tions network via said first, second and third nodes thereof- 

( 2. The system as recited in Claim 1 wherein said second Information revising circuitry Includes memory for storing a 
subscriber list, said second information revising circuitry transmitting said revision as a function of a content of said 
subscriber list. 

3. The system as recited In Claim 1 wherein said status reporting circuitry collects and transmits said current status 
25 of said second node information to said first node at a first time, status information circuitry associated with said 
third node collecting and transmitting said current status from said third node to said second node at a second time, 
said second time subsequent to said first time by a period of time sufficient to allow said second node information 
to be fully revised before said second Information revising circuitry transmits said revision to said third node. 

30 4. The system as recited in Claim 1 wherein said second Information revising circuitry is embodied in a sequence of 
Instructions operable on a second processor associated with said second node, said revision capable of Including 
revisions to said sequence of instructions, thereby allowing an operation of said second Information revising cir- 
cuitry to be modified. 

35 5. The system as recited in Claim 1 wherein said communications network is hierarchical, said first node functioning 
as a server for said second node, said second node functioning as a sen/er for said third node. 

6. The system as recited In Claim 1 wherein said first information revising circuitry Includes first security circuitry for 
^ authenticating said current status received from said second node before said first node transmits said revision to 

said second node and said second node includes second security circuitry for authenticating said revision received 
from said first node before revising said second node Information. 

7. The system as recited In Claim 1 wherein said first information revising circuitry revises said second node Informa- 
tion by logging on to said second node and transmitting a sequence of commands to said second node to enable 
said second node to receive said revision. 

8. A method of operation of a communications network for propagating revisions through said communications net- 
work, comprising the steps of: 

50 collecting and transmitting a current status of second node Information stored In a memory of a second node 

of said communications network; 

receiving said current status from said second node into a first node of said communications network, said first 
node determining as a function of said current status whether a revision of said second node information Is 
55 required and. if said revision Is required, transmitting said revision to said second node to revise said second 

node information; and 

receiving a current status from a third node of said communications network Into said second node, said sec- 
ond node determining as a function of said current status from said third node whether a revision of third node 
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information stored in a memory of said third node is required and, if said revision Is required, transmitting said 
revision received from said first node to said third node to revise said third node information, said revision 
thereby propagating through said communications network via said first, second and third nodes thereof. 

9. The method as recited in Claim 8 wherein said step of receiving said current status from said third node comprises 
the step of transmitting said revision as a function of a content of a subscriber list stored in said memory of said 
second node. 

10. The method as recited in Claim 8 wherein said current status of said second node information is collected and 
transmitted to said first node at a first time, said method further comprising the step of collecting and transmitting 
said current status from said third node to said second node at a second time, said second time subsequent to said 
first time by a period of time sufficient to allow said second node information to be fully revised before said second 
information revising circuitry transmits said revision to said third node. 

11. The method as recited in Claim 8 wherein said second node includes a sequence of instructions operable on a sec- 
ond processor associated with said second node, said revision capable of including revisions to said sequence of 
instructions, thereby allowing an operation of said second node to be modified. 

12. The method as recited in Claim 8 wherein said communications network is hierarchical, said first node functioning 
as a server for said second node, said second node functioning as a server for said third node. 

13. The method as recited in Claim 8 further comprising the steps of: 

authenticating said current status received from said second node before said first node transmits said revision 
to said second node; and 

authenticating said revision received from said first node before revising said second node information. 

14. The method as recited in Claim 8 said step of receiving said current status from said second node into said first 
node comprises the step of revising said second node information by logging on to said second node and transmit- 
ting a sequence of commands to said second node to enable said second node to receive said revision. 

15. A system for propogating revisions through a hierarchical communications network having a host a first-level node 
and a second-level node, comprising: 

status reporting circuitry, associated with said first-level node, for collecting and transmitting a current status of 
first-level node information stored in a memory of said first-level node at a first time; 

first information revising circuitry, associated with said host, for receiving said current status from said first-level 
node, determining as a function of said current status whether a revision of said first-level node information is 
required and, if said revision is required, transmitting said revision to said first-level node to revise said first- 
level node information; and 

second infomiation revising circuitry, associated with said first-level node, for receiving a current status from 
said second-level node at a second time, determining as a function of said current status from said second- 
level node whether a revision of second-level node information stored in a memory of said second-level node 
is required and, if said revision is required, transmitting said revision received from said host to said second- 
level node to revise said second-level node information, said second time subsequent to said first time by a 
period of time sufficient to allow said first-level node information to be fully revised before said second informa- 
tion revising circuitry transmits said revision to said second-level node, said revision thereby propagating 
through said communications network via said host, first-level and second-level nodes thereof. 

16. The system as recited in Claim 15 wherein said second information revising circuitry includes memory for storing 
a subscriber list, said second information revising circuitry transmitting said revision as a function of a content of 
said subscriber list. 

17. The system as recited in Claim 15 wherein said second information revising circuitry Is embodied in a sequence of 
instructions operable on a second processor associated with said first-level node, said revision capable of including 
revisions to said sequence of instructions, thereby allowing an operation of said second information revising cir- 



34 

<EP 07Q20eOAlJ_> 



10 



BP 0 782 080 A1 

cuitry to be modified. 

18. The system as recited in Claim 15 wherein said first information revising circuitry Includes first security circuitry for 
authenticating said current status received from said first-level node before said host transmits said revision to said 
first-level node and said first-level node includes second security circuitry for authenticating said revision received 
from said host before revising said first-level node information. 

19. The system as recited in Claim 15 wherein said second security circuitry authenticates said revision on a file-by- 
file basis. 

20. The system as recited in Claim 15 wherein said first information revising circuitry revises said first-level node infor- 
mation by logging on to said first-level node and transmitting a sequence of commands to said first-level node to 
enable said first-level node to receive said revision. 

15 21 . A system for propagating revisions through a comniunications network, said communications network including at 
least one first level node, at least one second level node and at least one third level node, said system comprising: 

status reporting circuitry, associated with said at least one second level node, operative to collect and transmit 
a second level cun-ent status of information stored in a memory of said at least one second level node; 
( first information revising circuitry, associated with said at least one first level node, operative to: (1) receive said 

second level current status of information from said at least one second level node, (2) determine, as a function 
of sard second level current status of information, whether a revision of said at least one second level node 
information is required, and (3) selectively transmit, in response to said determination, said revision of said at 
least one second level node information to said at least one second level node to revise said at least one sec- 

25 ond level node information; and 

second information revising circuitry, associated with said at least one second level node, operative to: (1) 
receive a third level current status of information from said at least on& third level node, (2) determine, as a 
function of said third level current status, whether a revision of said at least one third level node information 
stored in a memory of said at least one third level node is required, and (3) selectively transmit, in response to 

30 said determination, said revision received from said at least one first level node to said at least one third level 

node to revise said at least one third level node information, said revision thereby propagating through said 
communications network via said at least one first level, at least one second level and at least one third level 
nodes thereof. 
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